Bulk deletion of vehicles

The request allows you to logically delete (archive) several vehicles, using their IDs.

Request syntax

POST https://b2b-api.go.yandex.ru/integration/2.0/vehicles/bulk-archive

Request headers

• Authorization: Bearer <OAuth-token>
  OAuth access token. The steps to get a token are described in Getting started.

• X-YaTaxi-Selected-Corp-Client-Id — client ID from the account. Required if multiple clients are available using the token.

• X-Idempotency-Token — idempotency token, a string using UUID format. One idempotency token corresponds to one order; a new order requires generating a new token. Required header.

Request body

Data is transmitted in JSON format:

Response field description

Successful response doesn't contain a body (returns status 200 OK).

Request example

POST https://b2b-api.go.yandex.ru/integration/2.0/vehicles/bulk-archive
Authorization: Bearer <OAuth token>
X-YaTaxi-Selected-Corp-Client-Id: <client-id>
X-Idempotency-Token: <token>

  {
    "vehicle_ids": [
      "vehicle-abc-123",
      "vehicle-def-456"
    ]
  }

Response example

{ }

Possible response codes

• 200 — vehicles removed
• 400 — error validating parameters
• 404 — one or more vehicles not found
• 503 — server error